Skip to content

feat: Process Hub current-state + Layered Process View V1#95

Merged
jukka-matti merged 13 commits into
mainfrom
current-process-state-v1
Apr 27, 2026
Merged

feat: Process Hub current-state + Layered Process View V1#95
jukka-matti merged 13 commits into
mainfrom
current-process-state-v1

Conversation

@jukka-matti
Copy link
Copy Markdown
Owner

Summary

Two related changes that share methodology vocabulary updates and ship together because they touch overlapping doc files (methodology.md, llms.txt):

  1. Process Hub current state + product roadmap (commit a58b60a7)

    • New @variscout/core modules: processState.ts (318 LOC) + processHub.ts (37 LOC) — deterministic projections, no data-model rewrite
    • ProcessHubCurrentStatePanel.tsx render surface in Azure
    • Two new design specs: process-learning-operating-model-design.md, product-method-roadmap-design.md
    • Methodology + DATA-FLOW + USER-JOURNEYS + product-evaluation deck/narrative
  2. Layered Process View V1 (commits aa5c9fe2..bdc6386a, 12 commits)

    • New <LayeredProcessView> in @variscout/ui — wraps existing ProcessMapBase river-SIPOC in three bands (Outcome / Process Flow / Operations); props-only, no data-model change
    • PWA + Azure FrameView swap to the layered component (props pass through unchanged)
    • Spec + V1 plan + ADR-070 amendment + methodology / mental-model / llms.txt updates
    • Plan: docs/superpowers/plans/2026-04-27-layered-process-view-v1.md
    • Spec: docs/superpowers/specs/2026-04-27-layered-process-view-design.md

Test plan

  • pnpm --filter @variscout/ui build — clean
  • pnpm test — all packages green (PWA: +1 FrameView test, Azure: +1 FrameView test, UI: +9 LayeredProcessView tests, total ~5800+)
  • pnpm build — full monorepo
  • bash scripts/pr-ready-check.sh — green
  • claude --chrome walk on PWA (Showcase: Fill Weight): three bands render, factor chips show " at ", Outcome band shows Target/USL/LSL
  • claude --chrome walk on Azure (Coffee Moisture): three bands render, Operations placeholder when no factors mapped

Known follow-ups

  • Outcome band currently shows process specs (Target/USL/LSL) — design spec eventually moves these to Operations alongside per-step rate data (see V3+ in design spec). Recorded in ADR-070 Update — 2026-04-27.
  • Outcome band specs visually duplicate the ProcessMapBase ocean's spec inputs inside the Process Flow band; V1 plan's Task 9.4 explicitly says "do not redesign in V1; visual polish is allowed but not in scope for layout changes." Follow-up V2.
  • Pre-existing setState-in-render warning in PWA AppMain triggered by useQuestions → setQuestions → useInvestigationStore.loadInvestigationState call chain. Confirmed by git diff main HEAD over useQuestions.ts + App.tsx + investigationStore.ts (zero diff) — preexisting on main, not introduced by this branch.

Out of scope (deferred per the spec)

  • Cross-band SVG connector lines — V2+
  • Process Hub current-state rendering using LayeredProcessView — V2 (this PR ships the data model only; V2 wires the visual)
  • tributaryfactor code rename — separate PR before V3
  • Per-factor spec data model — V3
  • Snapshot-backed actuals + Cp/Cpk-over-batches mini-i-charts — V4

jukka-matti and others added 13 commits April 27, 2026 14:39
Three-band visual language (Outcome / Process Flow / Operations) layering
Watson's Makigami-style levels around the existing river-styled SIPOC FRAME
workspace. V1 wraps ProcessMapBase without changing the data model;
later phases add Operations band content, Process Hub current-state, and
multi-hub aggregation.

Captures design alignment from a brainstorm session (incorporating Codex's
review feedback on phasing and component placement). Plan handoff to V1
implementation work next.

Co-Authored-By: ruflo <ruv@ruv.net>
…around

Per code-quality review of Task 2:
- Drop trailing space inside <dt> labels; brittle to formatter passes.
- Switch outcome-band assertions to within().getByText() per element so
  Target:/value pairs are matched independently.
- Rename target test to drop the unrelated "Cpk" framing — `target` is a
  generic spec value, not specifically Cpk.
Co-Authored-By: ruflo <ruv@ruv.net>
Co-Authored-By: ruflo <ruv@ruv.net>
Co-Authored-By: ruflo <ruv@ruv.net>
…-model

Appended a 2026-04-27 update section to ADR-070 noting that ProcessMapBase
is now wrapped by LayeredProcessView with Outcome/Process Flow/Operations
bands. Added the matching paragraph to methodology.md after the Process
Learning Levels table, a layered-band note to the FRAME section in
mental-model-hierarchy.md, and a spec entry in llms.txt.
Fix meaningful-anchor, stacked-bands, and drop-(this-update) nits flagged
in code review of commit 441bf6e.

Co-Authored-By: ruflo <ruv@ruv.net>
@vercel
Copy link
Copy Markdown

vercel Bot commented Apr 27, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
mean-beoynd-lite-pwa Ready Ready Preview, Comment Apr 27, 2026 4:26pm
variscout_website Ready Ready Preview, Comment Apr 27, 2026 4:26pm

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant